home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / public / ImageMagick / README < prev    next >
Encoding:
Text File  |  1994-08-02  |  10.5 KB  |  295 lines
  1.   "I swear by my life and my love of it that I will never live for
  2.    the sake of another man, nor ask another man to live for mine."
  3.  
  4.                         John Galt in "Atlas Shrugged", by Ayn Rand
  5.  
  6.  
  7. AUTHOR
  8.  
  9.   The author is cristy@dupont.com.  This software is NOT shareware.
  10.   However, I am interested in who might be using it.  Please consider
  11.   sending me a picture postcard of the area where you live.  Send
  12.   postcards to
  13.  
  14.     John Cristy
  15.     5 Middleton Lane
  16.     Landenberg, PA  19350
  17.     USA
  18.  
  19. AVAILABILITY
  20.  
  21.   Anonymous FTP at ftp.x.org, file contrib/ImageMagick-2.3.7.tar.gz.  I want
  22.   ImageMagick to be of high quality, so if you encounter a problem I
  23.   will investigate. However, be sure you are using the most recent
  24.   version from ftp.x.org before submitting any bug reports or
  25.   suggestions.
  26.  
  27.  
  28. UNIX COMPILATION
  29.  
  30.   Type:
  31.  
  32.     gunzip ImageMagick2.3.7.tar.gz
  33.     tar xvf ImageMagick2.3.7.tar
  34.     cd ImageMagick
  35.     xmkmf
  36.     make Makefiles
  37.     make
  38.  
  39.   If you do not have 'gunzip', it is available as
  40.   prep.ai.mit.edu:pub/gnu/gzip-1.2.4.shar.  If you do not have 'xmkmf',
  41.   edit 'Makefile' as required by your hardware environment and type
  42.  
  43.     make
  44.  
  45.   Finally type:
  46.  
  47.     display images/aquarium.miff
  48.     display -monochrome -dither images/aquarium.miff
  49.  
  50.   If the image colors are not correct use this command:
  51.  
  52.     display -visual default images/aquarium.miff
  53.  
  54.   You can find other example images in the 'images' directory.
  55.  
  56.   Be sure to read the manual pages for the display, animate, montage,
  57.   import, mogrify, and convert utilities.
  58.  
  59.   The ImageMagick utilities read and write MIFF images.  Refer to the
  60.   end of this message for more information about MIFF.  Use `convert'
  61.   to convert images to and from the MIFF format.
  62.  
  63.   ImageMagick utilities recognizes these image formats:
  64.  
  65.        Tag       Description
  66.        ----------------------------------------------------
  67.        ALPHA     Raw alpha bytes
  68.        AVS       AVS X image file
  69.        BMP       Microsoft Windows bitmap image file
  70.        CMYK      Raw cyan, magenta, yellow, and black bytes
  71.        EPS       Adobe Encapsulated Postscript
  72.        FAX       Group 3
  73.        FITS      Flexible Image Transport System
  74.        GIF       Compuserve Graphics image file
  75.        GRAY      Raw gray bytes
  76.        JPEG
  77.        MAP       colormap intensities and indices
  78.        MIFF      Magick image file format
  79.        MTV
  80.        PCX       ZSoft IBM PC Paintbrush file
  81.        PICT      Apple Macintosh QuickDraw/PICT file
  82.        PNM       Portable bitmap
  83.        PS        Adobe PostScript file
  84.        PS2       Adobe PostScript Level II file
  85.        RGB       Raw red, green, and blue bytes
  86.        RLE       Utah Raster Toolkit
  87.        SUN       SUN raster
  88.        TGA       Truevision Targa image file
  89.        TEXT      raw text file;  read only
  90.        TIFF      Tagged Image File Format
  91.        VICAR
  92.        VIFF      Khoros Visualization image file.
  93.        X         select image from X server screen
  94.        XC        constant image of X server background color
  95.        XBM       X11 bitmap
  96.        XPM       X11 pixmap
  97.        XWD       X11 window dump
  98.        YUV       CCIR 601 1:1:1 file.
  99.        YUV3      CCIR 601 2:1:1 files.
  100.  
  101.   and for your convenience automatically converts the alien image
  102.   format to MIFF at execution time.  However, the MIFF image format has
  103.   several advantages over most image formats (i.e. runlength encoding,
  104.   digital signature on an image colormap, etc.).  ImageMagick is
  105.   designed to exploit these advantages.  Whenever possible convert an
  106.   alien image format to the MIFF format before using the various
  107.   ImageMagick programs.
  108.  
  109.   Other formats are also recognized.  See CONVERT(1) for a list of
  110.   valid image formats.  You can specify a particular image format by
  111.   prefixing the image filename with the image type and a colon (i.e.
  112.   ps:image.ps).
  113.  
  114.   ImageMagick requires GNU's Ghostscript software available via FTP as
  115.   ftp.uu.net:systems/gnu/ghostscript-2.6.1.tar.gz to read the
  116.   Postscript format.  For ImageMagick to read Postscript files, `gs'
  117.   must be in your execution path and the `pbmraw' and `ppmraw' devices
  118.   must be recognized (try gs -h to verify).  If they are not defined, add
  119.   them to your 'DEVICE_DEVS' define in your Ghostscript `Makefile' and
  120.   recompile (i.e. DEVICE_DEVS=x11.dev pbmraw.dev ppmraw.dev).
  121.  
  122.   ImageMagick requires picttoppm from contrib/netpbm-7dec1993.tar.gz on
  123.   ftp.x.org to read Macintosh PICT images.
  124.  
  125.   ImageMagick requires hpcdtoppm from contrib/netpbm-7dec1993.tar.gz on
  126.   ftp.x.org to Photo CD images.
  127.  
  128.   ImageMagick requires the Independent JPEG Group's software available via
  129.   FTP as ftp.uu.net:graphics/jpeg/jpegsrc.v4.tar.Z to read the JPEG image
  130.   format.
  131.  
  132.   ImageMagick requires Sam Leffler's TIFF software available via FTP as
  133.   sgi.com:graphics/tiff/v3.2beta.tar.Z to read the TIFF image format. If
  134.   you have an ANSI compiler, try sgi.com:graphics/tiff/v3.3beta002.src.tar.Z.
  135.  
  136.   ImageMagick requires Arnaud Le Hors XPM software available via FTP as
  137.   ftp.x.org:contrib/xpm-3.4a.tar.gz to read the XPM image format.
  138.  
  139.   To display images in the JPEG, TIFF, or XPM format, get the JPEG, TIFF,
  140.   or XPM archives and build ImageMagick as follows:
  141.  
  142.     cd ImageMagick
  143.     mkdir jpeg
  144.     cd jpeg
  145.     zcat jpegsrc.v4.tar.Z | tar xvof -
  146.     cp jmemnobs.c jmemsys.c
  147.     cp makefile.unix Makefile
  148.     make libjpeg.a
  149.     cd ..
  150.     mkdir tiff
  151.     cd tiff
  152.     zcat v3.2beta.tar.Z | tar xvof -
  153.     cd libtiff
  154.     cp Makefile.sun Makefile
  155.     make
  156.     cd ../..
  157.     mkdir xpm
  158.     < copy xpm-3.3/lib/* to xpm >
  159.     cd xpm
  160.     xmkmf
  161.     make
  162.     cd ..
  163.     < edit Magick.tmpl and define HasJPEG, HasTIFF, or HasXPM as instructed >
  164.     xmkmf
  165.     make Makefiles
  166.     make clean
  167.     make
  168.  
  169.   You can now display images in the JPEG or TIFF format.
  170.  
  171.  
  172. VMS COMPILATION
  173.  
  174.   Type
  175.  
  176.     @make
  177.     set display/create/node=node_name::
  178.  
  179.   where node_name is the DECNET X server to contact.
  180.  
  181.   Finally type:
  182.  
  183.     display [.images]aquarium.miff
  184.     display -monochrome -dither [.images]aquarium.miff
  185.  
  186.  
  187. ANIMATION
  188.  
  189.   An example animation sequence is available from anonymous FTP at
  190.   ftp.x.org, file contrib/ImageMagick.animation.tar.gz Or
  191.   alternatively, you can create this sequence yourself.  Just look at
  192.   README in the scenes directory.
  193.  
  194.   To prevent color flashing on visuals that have colormaps, `animate'
  195.   creates a single colormap from the image sequence.  This can be
  196.   rather time consuming.  You can speed this operation up by reducing
  197.   the colors in the image before you `animate' them.  Use `mogrify' to
  198.   color reduce the images:
  199.  
  200.     mogrify -colors 256 scenes/dna.[0-9]*
  201.  
  202.   Note, the image sequence in ImageMagick.animation.tar.gz is already
  203.   reduced.  Alternatively, you can use a Standard Colormap; or a
  204.   static, direct, or true color visual.  You can define a Standard
  205.   Colormap with `xstdcmap'.  For example, to use the "best" Standard
  206.   Colormap, type:
  207.  
  208.     xstdcmap -best
  209.     animate -map best scenes/dna.[0-9]*
  210.  
  211.   or to use a true color visual:
  212.  
  213.     animate -visual truecolor scenes/dna.[0-9]*
  214.  
  215.   Image filenames can appear in any order on the command line if the
  216.   scene keyword is specified in the MIFF image.  Otherwise the images
  217.   display in the order they appear on the command line.  A scene is
  218.   specified when converting from another image format to MIFF by using
  219.   the "scene" option with any filter.  Be sure to choose a scene number
  220.   other than zero.  For example, to convert a TIFF image to a MIFF
  221.   image as scene #2, type:
  222.  
  223.     convert -scene 2 image.tiff image.miff
  224.  
  225.  
  226. MIFF IMAGE FORMAT
  227.  
  228.   MIFF is an image format which I developed.  I like it because it
  229.  
  230.     1) It is machine independant.  It can be read on virtually any
  231.        computer.  No byte swapping is necessary.
  232.  
  233.     2) It has a text header.  Most image formats are coded in binary
  234.        and you cannot easily tell attributes about the image.  Use
  235.        'more' on MIFF image files and the attributes are displayed in
  236.        text form.
  237.  
  238.     3) It can handle runlength-encoded images.  Although most scanned
  239.        images do not benefit from runlength-encoding, most
  240.        computer-generated images do.  Images of mostly uniform colors
  241.        have a high compression ratio and therefore take up less memory
  242.        and disk space.
  243.  
  244.     4) It allows a scene number to be specified.  This allows you to
  245.        specify an animation sequence out-of-order on the command line.
  246.        The correct order is determined by the scene number of each
  247.        image.
  248.  
  249.     5) MIFF computes a digital signature for colormapped images.  This
  250.        is useful for animating a sequence of images on a colormapped X
  251.        server.  If all signatures match in the image sequence,
  252.        computing a global colormap is not necessary.
  253.  
  254.     6) There is a `montage' keyword allowing an image to act as a visual
  255.        image directory.  See display(1) for more details.
  256.  
  257.   One way to get an image into MIFF format is to use `convert'.  or
  258.   read it from an X window using the 'import' program.  Alternatively,
  259.   type the necessary header information in a file with a text editor.
  260.   Next, dump the binary bytes into another file.  Finally, type
  261.  
  262.     cat header binary_image | display -write image.miff -
  263.  
  264.   For example, suppose you have a raw red, green, blue image file on
  265.   disk that is 640 by 480.  The header file would look like this:
  266.  
  267.     id=ImageMagick columns=640 rows=480 :
  268.  
  269.   The image file would have red, green, blue tuples (rgbrgbrgb...).
  270.  
  271.   Refer to the 'display' manual page for more details.
  272.  
  273. COPYRIGHT
  274.  
  275.   Copyright 1994 E. I. du Pont de Nemours & Company
  276.  
  277.   Permission to use, copy, modify, distribute, and sell this software and
  278.   its documentation for any purpose is hereby granted without fee,
  279.   provided that the above copyright notice appear in all copies and that
  280.   both that copyright notice and this permission notice appear in
  281.   supporting documentation, and that the name of E. I. du Pont de Nemours
  282.   & Company not be used in advertising or publicity pertaining to
  283.   distribution of the software without specific, written prior
  284.   permission.  E. I. du Pont de Nemours & Company makes no representations
  285.   about the suitability of this software for any purpose.  It is provided
  286.   "as is" without express or implied warranty.
  287.  
  288.   E. I. du Pont de Nemours & Company disclaims all warranties with regard
  289.   to this software, including all implied warranties of merchantability
  290.   and fitness, in no event shall E. I. du Pont de Nemours & Company be
  291.   liable for any special, indirect or consequential damages or any
  292.   damages whatsoever resulting from loss of use, data or profits, whether
  293.   in an action of contract, negligence or other tortious action, arising
  294.   out of or in connection with the use or performance of this software.
  295.